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SECTION I 

GENERAL INTERNAL OUTLINE OF 170D MACRO ASSEMBLER 
New Features of the 1700 Macro Assembler 

A. Suppression of sequence errors when an * is en- 
countered in column 73 -Cno sequence errors from inserts 
or deletes made by C0SYI- 

B. Date will be listed in the heading on each page ex- 
except for the table at the end- 

C. Suppression of page ejects under no list INLS]- . 

Internal Flow of the 1700 Macro Assembler 

The Macro Assembler is written in 5 segments. One seg- 
ment is the controlling routiner ASSEM; the other four 
segments are the three passes of the assembler and TABLST- 

Segment ASSEM 

ASSEM is the controlling program of the assembler- The 
beginning of each pass contains this program- The program 
is also on the program 1 ibrary as a separate relocatable 
program which is loaded when *ASSEM is typed in- 

Each ASSEM is the same length- The commands in each 
ASSEM are the same except for an E(3U defining the symbol 
PS r the Wl and UE parameters of the GTFILE request r and 
the ADC at the end of the program- 

The function of ASSEM is to read in the passes of the 
assembler and start execution of the pass read in- It 
also checks to make sure the absolute base of the pass read 
in is correct. ASSEM overlays itself when each pass is 
read in- This is why each ASSEM is the same length 
and has about the same coding. Each pass of the assembler 
exits to ASSEM at completion of the pass- 

ASSEM as a Separate Program 

In this program PS is set to minus zero- Because it is 
negative? the first time switch in common storage is 
zeroed out- Also? because it is zero? it tells the 
program to read in PASS1 of the assembler- U1 and UE in 
the GTFILE request are zero? meaning the whole permanent 
fi le of PASS1 wi 1 I be read in- 
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ASSEn in PASS1 

In this program PS is set to one which tells the program 

to read in PASSE- Wl and WE in the GTFILE request are 

zeror meaning the whole permanent file of PASSE will be 
read in- 

ASSEM in PASSE 

In this program PS is set to two which tells the program 

to read in PASS3- In the GTFILE request Wl is set to one 

and WE is set to the length of PASS3- WE is used within 
PASSE to set to determine the starting address of the 
symbol table- If the length of PASS3 is changedr WE in 
this ASSEN should also be changed- 

ASSEM in PASS3 

In this program PS is set to three which tel Is the program 
to read in TABLST. Wl and WE in the GTFILE request are 
zeror meaning the whol permanent file of TABLST will be 
read in- 

ASSEM in TABLST 

In this program PS is set to zero which tells the program 
to read in PASS1- Wl and WE in the GTFILE request are 
zerof meaning the whole permanent file of PASS1 will be 
read i n - 

Flowchart of ASSEM 

General Flowchart of PASS1 

General Flowchart of PASSE 

General Flowchart of PASS3 

Switches and Holders Common to all Passes 

Symbolic Name Mean i ng 

1- ERC Holder for error count 

2- FST First time switch set by ASSEM 

3- ILSCND Contains sector number of last 

IL sector 


\ 
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Contains the sector number of 
first IL sector 

Switch set when L option is 
se 1 ected 

Contains largest sector address 
assembler may access 

Switch set when M option is 
sel ected 

Switch set when P option is 
sel ected 

Starting sector of mass storage 
scratch area used by assembler 

Switch set when X option is 
s e 1 ected 
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SECTION II - PASS 1 

2 . 


2.1 


2 . 1.1 
2. 1.2 
2.2 


2 . 2.1 

2 . 2.2 

2.3 


2.3.1 

2.4 


2.4.1 

2.5 


Pass 1 processes macro definitions, macro instructions and builds 
a copy of the source input on the mass storage device. 

Macro Definition Routine (MACDEF) 

The macro definition routine processes programmer defined macros. 

It builds a macro directory and skeletons on the mass storage de- 
vice. The input macro skeletons are preprocessed and binary values 
are substituted for formal parameters and local labels. 

This routine is the basis for the separate program LIBMAC which 
processes library macro definitions for output to the program 
library. 

Flow Chart of Macro Definition Routine 

Format of Macro Directory and Skeletons on Mass Storage 

Macro Call Routine (MACCAL) 

The Macro Call Routine processes macro instructions and builds the 
actual parameter table. Special handling is used for macros in depth 
and continuation images. Local labels are assigned unique values in 
this routine. 

Flow Chart of Macro Call Routine 

Actual Parameter Table Format 

Macro Continuation Image Routine (MACCON) 

This routine checks the legality of the continuation image opcode 
and exits to the Macro Call Routine. 

Flow Chart of Macro Continuation Image Routine 

Macro Get Routine (MACGET) 

Macro Get substitutes actual parameters into the macro skeletons and 
outputs the skeletons to mass storage intermediate language. 

Flow Chart of Macro Get Routine 

End Macro Routine (ENDMAC) 

This routine is used to remove the macro get mode. The routine is 
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2.6 



2 . 6.1 


2 . 6.2 


2.7 



entered when an EMC image is encountered. If the macro was in depth, 
the previous actual parameter table is read back into core. 

Flow Chart of End Macro Routine 

Macro Character Processor (MCHPR) and Character Pick Up Routines 
( CHPU ) 

The Macro Character Processor is used to process certain fields within 
macro images and non-macro images. It is used to pick up the opcode 
field symbol, formal parameters and local labels. There are two 
modes of operation, initial and alphanumeric. A field is processed 
until a terminator of blank, comma, plus, minus, or asterisk is 
encountered. 

The character pickup routine picks up one character from the input 
image. If a special flag, AF, is set, the routine exits with the 7 
bit value of the character. If this flag is not set, a six bit value 
is given for the character. If the switch IG is set at entrance, 
leading blanks are ignored. 

Flow Chart of Macro Character Processor 

Flow Chart of Character Pickup Routine 

Miscellaneous Macro Subroutines 

CHRPIC - This routine is used to get a character from the input 
source image or from the macro skeleton. It exits with the character 
in the A register. If the end of the image was reached, the A 
register is set negative at exit. 

NEWPUT - This routine places characters in new images being generated 
by substituting parameteirs. If the new image is full, the A register 
is set negative at exit. 

CRPUT - This routine is used to place a carriage return at the end of 
a new image. 

ACTPUT - This routine places characters of actual parameters in the 
current actual parameter table. 

ACTPIC - This routine gets characters from the actual parameter table. 

SKLGET - This routine is used to read in a skeleton sector from either 
the scratch area ojT library area of the mass storage device. 

GETOP - This routine is used to get the opcode of an image and con- 
vert it to a 15 bit value. The holder NU is used for the value. 

The routine sets this holder negative if an asterisk remark image 
is found. 
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2.8 


2 . 8.1 


2.9 


2*9.1 


2.9.2 


2.10 


MOVIMG - This routine is used to move a whole image into the new 
image buffer. 

SKLOUT - This routine is used to output the current skeleton buffer 
to mass storage. 

MER - This routine is used to print errors found in PASS1. 

Flow Chart of Miscellaneous Macro Subroutines 
Read Image Routine (READIM) 

This routine reads source images from the standard input device. 

Each image is read into a 41 word buffer and then moved to a two 
image 96 word buffer. The reading is partially buffered in that the 
next read is initiated before the routine exits. This routine also 
does the sequence number checking. 

Flow Chart of Read Image Routine 

Intermediate Language Subroutines 

PIL - This routine sets the print only IL bit in the 43rd word 
of the image. The routine calls IL to output the image. 

IL - This routine outputs the IL buffer (double image input buffer) 
to mass storage. 

ILOVFL - This routine checks for overflow of the IL area on mass 
storage. 

Flow Chart of Intermediate Language Subroutines 
Sector Format of Intermediate Language 
Table of Core Allocation During PASS1 


2.11 

2.12 

2.13 


Table of Mass Storage Allocation During PASS1 
Opcode table Used in PASS1 

Buffers, Switches, and Holders Used in PASS1 


SYMBOLIC NAME 

1. ACADR 

2. ACC 

3. ACSECT 


MEANING 

Contains address of current actual table 

Character counter for ACTPIC subroutine 

Sector number for next output of actual table 
to mass storage. 




n 
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SYMBOLIC NAME 

4. ACTBL 

5. ACTBL2 

6. AF 

7. AP 

8. BUFFSW 

9. CHST 

10. CM 

11. CM1 

12. CONS 

13. CRPADR 

14. CS 

15. CT 

16. DC 

17. DIRBUF 

18. DIRINX 

19 . FPRINX 

20. FSTM 

21. IG 

22. ILSECT 

23. INBUF 

24. INBUF 1 

25. INPADR 

26. INSKBF 

27. LN 


MEANING 

First actual table. This table is always used 
when substituting parameters in the skeletons 

Second actual table. Used when macro is called 
in depth. 

Switch for CHPU so that 7 bit character, is 
returned. 

Apostrophe switch. Used in MACCAL routine 

Input buffer switch. Indicates which half of 
INBUF the next image should go into. 

Temporary storage in NEWPUT. 

Comma switch in MACCAL. Used to check legality 
of apostrophes in actual parameter list. 

Comma switch in MACCAL. Used to determine 
continuation image. 

Start of reserved area for switches and holders. 

Contains address of image for CHRPIC routine. 

Character store. Contains character picked up 
by CHPU. Contains terminator after MCHPR has 
been used. 

Character counter for CHPU subroutine. 

Depth counter when macros are being called. 

Used to build and search macro directories. 

Index used when building macro directory. 

Index used for formal parameter search. 

First time switch for read image routine. 

Switch set to ignore leading blanks in CHPU. 
Current IL sector number. 

Double image input buffer - also used for output 
buffer of IL 

1/0 input buffer. Images are initially read 
into this buffer. 

Contains address of current image in INBUF 1 
96 word buffer to read in skeleton sector 
Current line number. 
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SYMBOLIC NAME 

MEANING 

28. 

LOCSW 

Switch used in processing local labels. 

29. 

LOCTOT 

Count of total local lagels in a subprogram. 

30. 

MSW1 

Macro switch one. Tells CONA to go to MACGET 
routine. 

31. 

MSW2 

Macro switch two. Indicates to CONA to go to 
MACCON for continuation image. 

32. 

NC 

Character counter for NEWPUT subroutine. 

33. 

NL 

Number local labels this macro. 

34. 

NOPG 

Switch for programmer defined macros. If set, 
program has programmer defined macros. 

35. 

NU 

Hold for converted 15 bit opcode. 

36. 

NULSW 

Switch in MACCAL and MACGET to indicate null 
parameters. 

37. 

PGSCST 

Start sector for programmer macro directory. 

38. 

PGSECT 

Current sector for programmer macro directory. 

39. 

PM 

Switch for programmer macro when macro is called 
0 = library macro, 1 = programmer macro. 

40. 

PTBL 

Formal parameter buffer area. 

41. 

RCS 

Read image completion switch. 

• 

CM 

SKBFSW 

Skeleton buffer switch. Indicates which half 
of SKLBUF is being used. 

43. 

SKLADR 

Address of current skeleton image in SKLBUF. 

44. 

SKLBUF 

96 word buffer for skeleton sector. 

45. 

SKSCST 

Start sector for skeletons. 

46. 

SKWDCT 

Count kept for pointer in macro directory to 
skeleton sector. 

47. 

SQ 

5 word hold for last sequence number 

48. 

SY 

4 word hold for symbol from MCHPR 

49. 

TP1 

Temporary storages 

50. 

T1 

Temporary storages 

51. 

XMOD 

Used in MCHPR - also used for temporary storage. 
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SECTION III - PASS 2 


3. Pass 2 builds the symbol table, processes the conditional assembly 

pseudo instructions, IFA and IFC, and processes the NAM record. 

Symbol table entries consist of labels, externals, entry points, 
and symbols defined in the address fields of the pseudo instructions 
BSS , BZS, EQU, COM and DAT. 

3.0 Flow Chart of PASS 2 initialization 


3.1 


3. 1.1 



3.2 



Next and Label Pickup Routines 

NEXT is the cyclical return for the pass. Its function is to get 
the next input source image from IL. 

LBPK processes the label field on the image. An asterisk remark 
image returns directly to NEXT. The label is stored into LA. 

Exit is to the Opcode Processor. 

Flow Chart of Next and Label Pickup Routines 

Opcode Processor 

The opcode processor checks the legality of the opcode and its 
terminator. If either is illegal, the instruction is processed 
as an ADC pseudo instruction. The class code and pseudo opcode 
index are picked up from the input record. If the class code points 
to a pseudo opcode, exit is through a transfer vector to the appro- 
priate pseudo processor. 

If the class code points to a machine opcode, the symbol put sub- 
routine is entered to stow the label, if any, in the symbol table. 
The program counter is incremented by one or two according to the 
type of machine instruction. Exit is to NEXT. 

If, on entry to the opcode processor, the Assembler is skipping 
input images as a result of a conditional IF instruction, there is 
an immediate exit to the skip processor. 

If the input image is a macro call, the macro depth switch is incre- 
mented, the label, if any, is stored in the symbol table and the 
program exits to NEXT. 

Opcodes are divided into classes as follows: 

Class 1 Machine Opcodes 

Group A Storage Reference Instructions 
Class 2 Machine Opcodes 

Group B Storage Reference Instructions 

Class 3 Machine Opcodes 

Register Instructions 
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Class 4 
Class 5 
C la s s 6 
Class 1 
Class 2 
Class 3 


Machine Opcodes 
Shift Instructions 
Machine Opcodes 
Skip Instructions 
Machine Opcodes 

Inter-Register Transfer Instructions 

Pseudo Opcode 

ADC 

Pseudo Opcodes 

ORG, EQU, COM, DAT, BSS, BZS 
Pseudo Opcodes 

END, ENT, EXT, ALF, NUM, DEC, VFD, IFA, IFC, EIF, EMC, 
LST, NLS, SPC, EJT 


3.2.1 


3.2.2 


3.3 


3.3.1 


3.4 


3.4.1 


Flow Chart of Opcode Processor 
Opcode Table Format 
Skip Processor Routine 

This routine is entered if images are being skipped due to an IF 
instruction. A macro if depth switch is kept to skip over macro 
instructions correctly. If an EIF is encountered the routine 
transfers to EIF2. 

Flow Chart of Skip Processor 

ADC, NUM and DEC Pseudo Processors 

The function of these processors is to place the label in the symbol 
table and increment the program counter according to the number of 
subfields on the source image. 

Flow Charts of ADC, NUM and DEC Pseudo Processors 


3.5 ORG, ORG* Pseudo Processor 

This processor sets and unsets the program counter. The counter 
is set on an ORG to the value of the address expression. The counter 
is unset when an ORG* is encountered. 

3.5.1 Flow Chart of ORG Pseudo Processor 


3.6 EQU Pseudo Processor 

This routine makes entries in the symbol table according to values 
given following the symbol name. The miscellaneous pseudo sub- 
routine D4 is used to get the name and its value. 

3.6.1 Flow Chart of EQU Pseudo Processor 


CA 1 38-1 



CONTROL DATA CORPORATION e DEVELOPMENT DIV • SOFTWARE DOCUMENT 

DOCUMENT CLASS IMS .PAGE NO 57 

PRODUCT NAMF 1700 MACRO ASSEMBLER 

PRODUCT NO AQQ7 VFRSION 3.0 MACHINE SERIES 1700 


3.7 


3.7.1 


3.8 


3.8.1 


3.9 


3.9.1 


3.10 


3.10.1 


3.11 


COM, DAT Pseudo Processor 

This routine makes entries in the symbol table with relocation of 
common or data. A counter is kept for each type to use as output 
on the NAM relocatable binary image. The miscellaneous Pseudo 
Subroutine D4 is used to get the name and the block length associ- 
ated with it. 

Flow Chart of COM, DAT Pseudo Processor 
BSS, BZS Pseudo Processor 

This routine makes entries in the symbol table which are the names 
of blocks of reserved storage. The program counter is ixremented 
according to the length of the block. The Miscellaneous Pseudo 
Subroutine D4 is used to get the name and the block length associ- 
ated with it. 

Flow Chart of BSS, BZS Pseudo Processor 
ENT Pseudo Processor 

This routine places entry points in the symbol table. If the symbol 
was already in the table, just the entry point bit in it is set. 

If the symbol was not in the table, it is entered with a reloca- 
tion of 4 to flag an undefined entry point. The miscellaneous 
pseudo subroutine D1 is used to get the symbol names. 

Flow Chdrt of ENT Pseudo Processor 

EXT Pseudo Processor 

This routine places names external to the program in the external 
table. If the opcode terminator was an asterisk, the entry is 
flagged as relative. A name encountered that is already in the 
external table must be the same type (relative or non-relative) 
as the entry in the external table. The external table is built 
backwards starting with the highest location in the symbol table. 

The miscellaneous pseudo subroutine D1 is used to get the external 
names. 

Flow Chart of EXT Pseudo Processor 
ALF Pseudo Processor 

The function of this processor is to place the label in the symbol 
table and increment the program counter. If the length is deter- 
mined by a number in the first subfield, the characters are not 
scanned. If the length is determined by an ending character, the 
characters are scanned to count the number of words in the character 
string. The subroutine ALFSB2 is used to get a character, and 
check for special characters. 
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3.11.1 

3.12 


3.12.1 


3.13 


3.13.1 


3. 14 


3.14.1 


3.15 


3.15.1 


3.16 


3.16.1 


3.17 


Flow Chart of ALF Pseudo Processor and Subroutine ALFSB2 
VFD Pseudo Processor 

The function os this processor is to place the label in the symbol 
table and increment the program counter. A bit count is kept and 
when it reaches 16 or greater the program counter is incremented 
by one. 

Flow Chart of VFD Pseudo Processor 
IFA Pseudo Processor 

This routine determines whether the condition of the IF is satis- 
fied or not satisfied. If the condition is not satisfied, a switch 
is set to cause skipping of following source images. A holder is 
used to save the first two characters of the label field for com- 
parison when an EIF is encountered. 

Flow Chart of IFA Pseudo Processor 

IFC Pseudo Processor 

This routine determines whether the condition of the IF is satisfied 
or not satisfied. If the condition is not satisfied, a switch is 
set to cause skipping of the following source images. A holder is 
used to save the first two character of the label field for com- 
parison when an EIF is encountered. 

Flow Chart of IFC Pseudo Processor 

EIF Pseudo Processor 

This routine determines whether to stop skipping cards if the skip 
switch is set. The first two characters of the address field are 
compared to a holder set by the controlling IF. If they compare, 
the IF switch is turned off. 

Flow Chart of EIF Pseudo Processor 

EMC Pseudo Processor 

The function of this routine is to decrement the macro depth 
counter. 

Flow Chart of EMC Pseudo Processor 
END Pseudo Processor 

This routine outputs the NAM record and initializes buffers and 
switches for Pass 3. Exit is through ASSEM to Pass 3. 
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3. 17.1 


3. 18 


3. 18.1 


3. 19 


3. 19.1 


3. 19.2 


3.20 


3.20.1 


3.21 


3.21.1 


3.22 


Flow Chart of END Pseudo Processor 
Miscellaneous Pseudo Subroutines 

These routines are used to pick up subfields for some pseudo instruc- 
tions. The subroutine D4 has four exits as follows: 

(1) Mark - No symbol present 

(2) Mark+1 - No expression in subfield 

(3) Mark+2 - Non-absolute relocation 

(4) Mark+3 - Normal exit 

Flow Chart of Miscellaneous Pseudo Subroutine 
Symbol Table Putaway Subroutine 

This routine is used to place symbols in the symbol table. At 
entry the A register contains the value of the symbol and the Q 
register contains the relocation of the symbol. The symbol is in 
LA. If there is no symbol to put away, the routine exits 
immediately. Double definition of symbols is detected in this 
routine. 

Flow Chart of Symbol Table Putaway Subroutine 

Symbol Table Format 

Symbol Table Overflow Subroutine 

This routine is used to determine if there is enough room in the 
current symbol and external table for another entry. If there is 
not enough room, the current table is output to mass storage and 
a new table counters and addresses are initialized. A check is 
made for possible mass storage overflow. 

Flow Chart of Symbo 1 Table Overflow Subroutine 

Read Image Routine 

If both IL images in the sector have been processed, this routine 
reads in the next sector from mass storage. If the second image 
has not been processed, the input buffer address is bumped to the 
location of the second image. 

Flow Chart of Read Image Routine 

Error Routine 
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This routine outputs error messages to the standard comment medium. 
The error flag is also set in IL and the IL sector containing the 
erroneous source image is rewritten. ; 
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3.22.1 

3.23 


3.23.1 


Flow Chart of Error Routine 
NAM Pseudo Processor 

The NAM processor enters the reconversion routine to convert the 
symbol in the address field .to ASCII and saves the converted symbol 
for output at the end of Pass 2. The input record is flagged for 
Pass 3 as a "print only IL. " 

Flow Chart of NAM Pseudo Processor 
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SECTION IV - PASS 3 

4. Pass 3 processes the address field of all machine and pseudo 

instructions except EXT and NAM. Relocatable binary output and a 
listing are generated. 

4.1 Next and Label Pickup Routines 

NEXT the cyclical return for the pass. The Read Image Routine is 
entered to get the source image. If the assembler is skipping input 
images as the result of a conditional IF instruction, there is an 
immediate exit to the Label Pickup Routine. An error message is 
printed if the error bit has been set in the input record by a pre- 
vious ^ass. If the input record is flagged as a "print only IL", 
the image is printed and the Read Image routine is re-entered. 
Otherwise exit is to the Label Pickup Routine. 

LBPK is used to get the label field of the image. An asterisk as 
the 1st character causes label pickup to exit to IGNOR. Otherwise, 
it exits to the Opcode Processor. 

4.1.1 Flow Chart of Next and Label Pickup Routines 

4.2 Opcode Processor 

This routine gets the opcode, checks its terminator, places the 
binary instruction in the command word, and transfers according to 
the type of instruction. If images are being skipped due to an IF 
instruction, the skip processor is entered. If a macro call is 
encountered, the depth switch is incremented and a print switch is 
set according to the M control option. 

4.2.1 Flow Chart of Opcode Processor 

4.3 Skip Processor 

This routine is the same as in Pass 2 except that if an EIF is found, 
exit is to EIF3. 

4.3.1 Flow Chart of Skip Processor 

4.4 ADC Pseudo Processor 

This routine gets the binary value for subfields of the address 
field. The program counter is incremented for each subfield. It 
is also entered from the Machine Address Processor to process a 
literal. 
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4.4.1 Flow Chart of ADC Pseudo Processor 


4.5 


4.5.1 


4.6 


NUM Pseudo Processor 

This routine gets the binary value for subfields of the address 
field. The program counter is incremented for each subfield. 

It is also entered from the Machine Address Processor to process 
a literal. 

Flow Chart of NUM Pseudo Processor 
DEC Pseudo Processor 

This routine gets the binary value for subfields of the address field. 
The program counter is incremented for each subfield. A power of 
ten table is used for conversion. Scaling is done when division 
is necessary. 


4.6.1 


4.7 

o 


4.7.1 


4.8 


4.8.1 


4.9 


4.9.1 


4.10 



Flow Chart of DEC Pseudo Processor 
ORG, ORG* Pseudo Processor 

This routine is the same as the Pass 2 routine except that UNCP 
is used to output the current RBD image. 

Flow Chart of ORG, ORG* Pseudo Processor 

EXT Pseudo Processor 

.This routine exits to IGNOR which prints the image. 

Flow Chart of EXT Pseudo Processor 
EQU Pseudo Processor 

The Miscellaneous pseudo subroutine D4 is entered to get the symbol 
and the expression value. The expression value is stored in Wl. 

Exit is to Miscellaneous pseudo subroutine D1 which prints the image 
and checks the next field. 

Flow Chart of EQU Pseudo Processor 

COM, DAT Pseudo Processor 

The Miscellaneous pseudo subroutine D4 is entered to get the 
symbol and the expression value. The common or data counter is stored 
in Wl and the counter is increased by the expression value. Relo- 
cation is set to common or data. Exit is to pseudo subroutine D1 
which prints the image and checks the next field. 
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4.10.1 


4.11 


4.11.1 

4.12 


4.12.1 


4.13 


4.13.1 


Flow Chart of COM, DAT Pseudo Processor 
BSS, BZS Pseudo Processor 

The program counter is incremented according to the block sizes in 
the address field. No binary output is generated for a BSS, but 
UNCP is called to output the current binary image. If the instruction 
is a BZS, binary words of zero are generated to fill the current 
image. If this image gets filled, a BZS binary image is generated 
for the remainder of the block. 

Flow Chart of BSS, BZS Pseudo Processor 

ENT Pseudo Processor 

The function of this routine in Pass 3 is to find illegal entry 
points. An entry point is illegal if it is undefined or if its 
relocation is common or data. 

Flow Chart of ENT Pseudo Processor 

ALF Pseudo Processor 

This processor increments the program counter and places the char- 
acter in the binary image. If the length is determined by a number 
in the first subfield, the routine does not look for a terminating 
character. If the length is determined by a temnating character, 
output stops when this character is reached. The routine contains 
two subroutines ALFSB and ALFSB2. ALFSB gets a word .of output (2 
characters). If a character is the terminator, and it is the first 
character of a word, ALFSB exits with the A register negative to 
show end of character string. ALFSB2 gets a character of output. 

It processes the special output characters which are flagged by a 
colon on the input. ALFSB2 is used by the VFD processor. The 
ALF Pseudo Processor is entered from the Machine Address Processor 
to process a literal. 

Flow Chart of ALF Pseudo Processor 


4. 14 VFD Pseudo Processor 

This processor increments the program counter according to the 
bit counts and outputs the binary constants. Each mode of constant 
is handled separately but a common subro utine is used to output 
a word when it is filled. 


4.14.1 Flow Chart of VFD Pseudo Processor 

4. 15 IFA Pseudo Processor 

This processor is the same as in Pass 2. 


CA138-1 



CONTROL DATA CORPORATION • DEVELOPMENT DIV o SOFTWARE DOCUMENT 

DOCUMENT CLASS IMS PAOF NO 101 

PRODUCT Name 1700 MACRO ASSEMBLER 

PRODUCT NO. AQ07 VERSION 5*° MACHINF SFRIFS 1700 


4.15.1 


4.16 


4.16.1 


4.17 


4.17.1 


4.18 


4.18.1 


4.19 


4.19.1 


4.20 


4.20.1 

4.21 


4.21.1 


Flow Chart of IFA Pseudo Processor 
IFC Pseudo Processor 

This processor is the same as in Pass 2 
Flow Chart of IFC Pseudo Processor 
EIF Pseudo Processor 

This processor is the same as in Pass 2. 

Flow Chart of EIF Pseudo Processor 
EMC Pseudo Processor 

The function of this routine is to decrement the macro depth counter 
and to unset the macro print switch. 

Flow Chart of EMC Processor 

END Pseudo Processor 

This processor prints the END card and exits through ASSEM to 
Pass 4. 

Flow Chart of END Pseudo Processor 
Miscellaneous Pseudo Subroutine D4 

This subroutine enters Miscellaneous pseudo subroutine D1 and the 
address expression processor to get the symbol and the expression 
value. There are four possible exits from the subroutine depending 
on the following conditions: 


Exit to Mark 
Exit to Mark+1 
Exit to Mark+2 
Exit to Mark+3 


No symbol present 
No left parenthesis present 
Expression is relocatable 
Normal exit 


Flow Chart of Miscellaneous Pseudo Subroutine D4 


Miscellaneous Pseudo Subroutine D1 


This subroutine enters the Character Processor to get the symbol 
in the address field. If no error is returned from the Character 
Processor, it exits immediately. Otherwise an error message 
and the image are printed. If the next character is a comma, the 
Character Processor is re-entered. 

Flow Chart of Miscellaneous Pseudo Subroutine D1 
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4.22 


4.22.1 


4.23 


4.23.1 


4.24 


4.24.1 


4.25 


4.25.1 


4.26 


Machine Address Processor 

This routine processes the address field of machine commands. 

W1 and W2 are used to hold the command words (W2 is used in two 
word commands). Processing is done according to the class of the 
command. N, X and A literals are processed through the NUM, 

ADC and ALF pseudo processors. The program counter is incremented 
according to the number of words in the command. 

Flow Chart of Machine Address Processor 

Location Pack Subroutine 

This routine converts the current program counter to hex ASCII 
and places it in the print image. The relocation of the program 
counter is also placed in the print image. The subroutine WDPK 
is called before exiting. 

Flow Chart of Location Pack Subroutine 

Word Pack Subroutine 

This routine converts the command word to hex ASCII and places it 
in the print image. The relocation of the command word is also 
placed in the print image. The routine calls 'PENT before exiting. 

Flow Chart of Word Pack Subroutine 

Print Subroutine 

This routine outputs the print line if the list option has been 
selected and a no list pseudo instruction is ir> t in effect. The 
routine also outputs error messages to either the comment medium 
of the list medium. The printing is buffered by moving the current 
image to an alternate buffer for the actual printing. 

Flow Chart of Print Subroutine 

Pack Relocatable Binary Subroutine 

This routine is used to place the command word and its relocation 
byte into the binary image. A word count is kept. When an image 
is filled, the routine UNCP is called to output the image. 


4.26.1 Flow Chart of Pack Relocatable Binary Subroutine 

4.27 Unconditional Binary Punch Subroutine 
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This routine is called whenever output of the current 
relocatable b i nary image is described. The routine places 
the flag bit for end of image in the last re 1 ocat i on byte 
used- The routine PUNC is called for the actual output. 

4-27.1 Flow Chart of Unconditional Binary Punch Subroutine 

4-2fl Binary Punch Subroutine 

This routine outputs the binary image to the standard binary 
output device and to the load and go device. Output is 
determined by the X and P control option switches. The 
operation is buffered by moving the current image to an 
alternate buffer. 

4-2S.1 Flow Chart of Binary Punch Subroutine 
4 - 2^ Read Image Subroutine 

This routine is the same as in Pass 2. 

4 - 2 C 1 - 1 Flow Chart of Read Image Subroutine 

4- 3D Error Subroutine 

This routine packs the error message in a buffer. The buffer 
is determined by the setting of the L control option- The 
subroutine PRNT is called to output the line- 

4-3D-1 Flow Chart of Error Subroutine 
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SECTION V - TABLST 

5* TABLST prints and punches the entry point and ex- 

ternal images and punches the transfer image if the 
list and punch optiohs have been selected. If the 
load and go option has been selected an end of file 
image is output to the next load and go sector on 
mass storage- 

If the list switch is set r the symbol table is listed 
directly following the program listing. The number 
of errorsr if any r is output following the symbol 
table. 

TABLST exits through ASSEfl to PASS1. 

The subroutines used in TABLST have been described 
and flow charted in PASS3- 

5.1 Flow Chart of TABLST. 
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SECTION VI - UNIVERSAL ROUTINES 

6. These routines are used by more than one pass of the assembler. 

They are all subroutines. 

6.1 Address Expression Processor 

This routine evaluates an expression in the address field. The 
symbol and external tables are searched for the value of sym- 
bolic operands. The routine makes external links when externals 
are used as symbolic operands. The value of the expression is 
output in AX. The relocation of the expression is output in RC. 

If the expression was an external, EX is set to 1 for non-relative 
and 2 for relative. 

Tljg value of the expression in the address field is computed MOD 
2 -1 except when the flag, AX16, has been^get by the VFD processor. 

In this case the value is calculated MOD 2 -1. 



6 . 


1.1 


6.2 



6 . 2.1 


The address expression processor exits with the value of the expression 
in the A register and the relocation of the expression in the Q 
register. 

Flow Chart of Address Expression Processor 
Character Processor 


This routine processes a subfield to a terminator. Terminators 
are plus, minus, asterisk, slash, blank, comma, and left paren- 
thesis. Input switches to the routine are: 


(1) 

IS 

set if leading sign illegal 

(2) 

NS 

set if 16 bit hexadecimal operand legal 

Output from the 

routine is as follows: 

(1) 

SY 

Three word hold for symbolic operand 

(2) 

NU 

Numeric operand holder 

(3) 

ES 

Set if error occurred in CHPR 

(4) 

LP 

Set if left paren encountered 

(5) 

CS 

Contains code for terminator 

(6) 

SY+1 

If SY equals zero and SY+1 does not equal zero, 
a null field was encountered 

(7) 

SY+2 

If SY equals zero and SY+2 does not equal zero, 
an asterisk is the operand 

(8) 

SY+3 

Contains a count of the number of characters in 
SY 

(9) 

SG 

Set negative if leading sign minus; set greater 
than one if leading sign plus 


Flow Chart of Character Processor 
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6.3 Character Pickup Routine 

This routine gets a character from the input image. An input 
switch, IG, is used to signal the routine to ignore leading 
blanks. If the input switch AF is set, the routine exits with 
7 bit character output. Normal output is a 6 bit character in 
CS. 

6.3.1 Flow Chart of Character Pickup Routine 

6.4 Symbol Table In Subroutine 

This routine is used to read in symbol table blocks from the 
mass storage device. If there are no more blocks on mass storage, 
the subroutine RESTBL is entered to restore the original symbol 
table. The A register is set negative at exit to indicate there 
are no more blocks to input. 

6.4.1 Flow Chart of Symbol Table In Subroutine 

6.5 Restore Symbol Table Subroutine 

This routine is used to restore the original symbol table to core 
if it is not already there. 

6.5.1 Flow Chart of Restore Symbol Table Subroutine 

6.6 Symbol Table Search Subroutine 

This routine is used to search the symbol or external table for 
a given symbol. The address of the table to be searched is 
input in the Q register. Q is set negative at exit to indicate 
. that the symbol was not found. If Q is positive at exit it con- 
tains the address of the first word of the symbol entry in the 
table. 

6.6.1 Flow Chart of Symbol Table Search Routine 

6.7 Core Allocation Format Pass 2 and 3 

6.8 Mass Storage Allocation Format Pass 2 and 3 
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SECTION VII 

Switches, holders, flags, and buffers used in passes 2, 3 and 4 


SYMBOLIC NAME 

AD 

AF 

AM 


APB 

AR 

AS 

AU 


AUB 


AX 


AX16 

BS 

CC 

CL 

CS 


CSW 

CSYSCT 

CT 

DC 


MEANING 

Flag indicating opcode is ADC 

Flag indicating opcode is ALF 

Flag indicating type of opcode terminator for 
class 1 and 2 instructions 

Value Terminator 

-3 blank 

-2 not used 

-1 + 

0 

Alternate word print buffer 

Temporary holder for relocation code in AXPR 

Holds negative or positive mask in AXPR 

Temporary holder for address expression value 
in AXPR Used elsewhere as a temporary holder 
Alternate 57 word punch buffer 
Holder for final address expression value from 

AXPR 

Flag signalling 16-bit arithmetic in AXPR 
Buffer switch in RDIM 
Common counter 
Class code 

Holds output character from CHPU 
Holds terminator indicator from CHPR 


=0 b lank 

=1 comma 

=2 plus 

=3 minus 

=4 asterisk 

=5 slash 

=6 left parenthesis 

Complet lon> sw itch for punched binary out- 
put- 

Sector number of symbol table currently in core 
Image column counter 
Data counter 


DSbJ Completion switch for D0UT 


DSULd 


Completion switch for DIN 
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SYMBOLIC NAME 
DVFL 


DX 

ES 

ET 

ETSAVE 

EX 


HX 

IB 

IFNAM 

IG 


IL 

IS 


LA 

LC 

LN 

LP 

LT 

MD 

MPSW 

NU 

NS 


MEANING 
Overlay flag 

=0 VFD processor is in core 

=1 DEC processor is in core 

Flag identifying pseudo processors that are 
processed in the same routine. Used elsewhere 
as a temporary holder 

Error switch 

Holder for current external table address 

Save storage for external table address in 
TBLIN and RESTBL 

Flag indicating external 

=1 Non-relative external 

=2 relative external 

Flag indicating hex value in CHPR. Used else- 
where as temporary storage 
Input buffer for IL image 
If depth counter 

Holder for first two characters of the labei 
of an IFA or IFC instruction 

Ignore leading blanks switch 

=0 leading blanks processed 

^0 leading blanks ignored 

Holder for flag bits from input image 

Flags legality of leading sign for CHPR 

=0 leading sign legal 

leading sign illegal 

Four word holder for label LA+3 contains number 
of characters in the label minus 1 

Holder for leading operator in AXPR. Codes 
are the same as CS 

Holder for line number 

Flag indicating left parenthesis present in 
address expression 

Flag indicating address field contains a literal 
Macro depth counter 
Macro print switch 

Holder for numeric address value from CHPR 
Flag indicating a 16-bit value is legal in CHPR 
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SYMBOLIC NAME MEANING 


OC 


Save storage for the program counter in 
ORG 


OR 


Save storage for program re 1 ocat i on in 
ORG 


PAGL 


Page length 


PB 

PC 

PER 

PNAM 

PSbJ 

RC 


RP 

SC 


MT-word print buffer 
Program counter 

Holder for number of words to be punched. 
Used as temporary storage elsewhere- 

3 word hold for name of program to print 
on top of page 

List output completion switch 
Relocation code of the address expression 


= 0 

abso 1 ute 


=1 

program 


= 2 

common 


= 3 

data 


= 5 

negat i ve 

program 

= L 

negat i ve 

common 

= 7 

negat i ve 

data 


Flag indicating right parenthesis is 
present in the address expression 

Count of entries in the symbol table 


SCOUNT Number of MS sectors occupied by one 

symbol table block 


SECTNO Current IL sector number 


SG 

Leading sign 

indicator from CHPR 


<□ 

leading minus 


= □ 

no leading sign 


>□ 

I ead i ng pi us 
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SYMBOLIC NAME 
SKF 

SL 

ss 


ST 

SY 


SZ 

TR 

TSU 

UB 

VBT 

VCT 

VMS 


VUD 

U1 


MEANING 

Flag indicating assembler is skipping 
images on an IF condition 

Length of the source image 

Flag for SYCH indicating location of 
symbol 


= □ 
=1 


symbol in LA 
symbol in SY 


Holder for beginning symbol table address 

M word symbol holder from CHPR SY+3 holds 
number of characters in the name minus 1 
If no symbol is present the following 
flags may be inserted 

S Y+l * 0 null field 

SY + E ? 0 symbol is an asterisk 

Size of a BZS block 

7 word holder for relocation codes in 
AXPR. Used elsewhere for temporary 
storage 

Typewriter completion switch 

57 word punch buffer 

Total bit count used in VFD. Used 
elsewhere as temporary storage 

Bit count of current address field used 
VFD. Used elsewhere as temporary storage 

Mode switch in VFD 


= 1 
= E 
=3 


A 

N 

X 


Used elsewhere as temporary storage 

Holder for binary word in VFD- Used 
elsewhere for temporary storage 

Holder for first command output word 
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UE Holder for second command output word 

UJ C Number of words currently stored in the 

punch buffer 

bJMS Number of storages available for each 

symbol table block 

XMOD Initial mode switch in CHPR. Used 

elsewhere as temporary storage 

XSYSCT Number of next available sector for a 

symbol table block on mass storage 

YL List - No list switch set by LST and NLS 

pseudo instructions 

= □ 1 ist 

no 1 ist 
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